home *** CD-ROM | disk | FTP | other *** search
- // Copyright (C) 1997-2002 Alias|Wavefront,
- // a division of Silicon Graphics Limited.
- //
- // The information in this file is provided for the exclusive use of the
- // licensees of Alias|Wavefront. Such users have the right to use, modify,
- // and incorporate this code into other products for purposes authorized
- // by the Alias|Wavefront license agreement, without fee.
- //
- // ALIAS|WAVEFRONT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
- // INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
- // EVENT SHALL ALIAS|WAVEFRONT BE LIABLE FOR ANY SPECIAL, INDIRECT OR
- // CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
- // DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
- // TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- // PERFORMANCE OF THIS SOFTWARE.
- //
- //
- // Alias|Wavefront Script File
- // MODIFY THIS AT YOUR OWN RISK
- //
- //<doc>
- //<name normalize>
- //<owner "Alias|Wavefront Unsupported">
- //
- //<synopsis>
- // int normalize( float $v[] )
- //
- //<description>
- // Normalizes a float array of 3 values.
- //
- //<flags>
- // float[] $v Array of 3 floats to be normalized
- //
- //<returns>
- // int : -1 if the float array was zero length.
- // 1 if the normalized vector was successfully calculated.
- //
- //</doc>
- //
- global proc int normalize( float $v[] )
- {
- if ( size($v) != 3 )
- warning("normalize(): You must give a float array of 3 values as the argument.");
-
- float $factor = 1.0;
- float $len = $v[0]*$v[0] + $v[1]*$v[1] + $v[2]*$v[2];
-
- if( $len == 0.0 ) return -1;
- else $factor = 1.0/sqrt($len);
-
- if ( $factor != 1.0 )
- {
- $v[0] *= $factor;
- $v[1] *= $factor;
- $v[2] *= $factor;
- }
-
- return 1;
- }
-